chore: announce kafka connector group ID generation strategy change#8432
chore: announce kafka connector group ID generation strategy change#8432chillleader wants to merge 3 commits intomainfrom
Conversation
36150be to
87b5303
Compare
|
👋 🤖 🤔 Hello, @christinaausley! Did you make your changes in all the right places? These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.8/.
You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines. |
| </div> | ||
| <div className="release-announcement-content"> | ||
|
|
||
| #### Kafka Consumer connector: auto-generated consumer group ID format changed |
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[all.glossary] Inconsistent spelling detected. Use Kafka consumer instead of Kafka Consumer. Review the WCoE glossary - https://confluence.camunda.com/x/b5RZBw .
|
|
||
| Because Kafka treats a changed group ID as a brand-new consumer group, connectors using an auto-generated group ID after upgrading will lose their committed offsets and may reprocess messages. | ||
|
|
||
| **Action required:** Before upgrading to 8.9, set an explicit **Consumer Group ID** in each Kafka Consumer connector configuration to preserve consumer group identity. See the [Kafka connector documentation](/components/connectors/out-of-the-box-connectors/kafka.md?kafka=inbound) for details. |
There was a problem hiding this comment.
🚫 [vale] reported by reviewdog 🐶
[all.glossary] Inconsistent spelling detected. Use Kafka consumer instead of Kafka Consumer. Review the WCoE glossary - https://confluence.camunda.com/x/b5RZBw .
Description
Added an announcement about a potentially breaking change, affecting some users during 8.8-8.9 migration. The change is related to the Kafka connector's default consumer group ID generation strategy that has changed between minors.
Also adjusted the connector docs to emphasize the importance of defining a custom group ID.
When should this change go live?
bugorsupportlabel)available & undocumentedlabel)holdlabel)low priolabel)PR Checklist
{type}(scope): {description}commit message(s)/docsdirectory (version 8.9)./versioned_docsdirectory.@camunda/tech-writersunless working with an embedded writer.